FAXD.RECV

Section: Misc. Reference Manual Pages (1M)
Updated: July 27, 1993
Index Return to Main Contents
 

NAME

faxd.recv - facsimile job submission server  

SYNOPSIS

${USRETC}/faxd.recv [ -q queue-dir ] [ -d ]  

DESCRIPTION

faxd.recv is the program that implements the server side of the facsimile job submission protocol. It also, implements some ad hoc extensions to this protocol to support the removal of jobs and the return of status information. faxd.recv is normally invoked by inetd(1M) with a line of the form:

fax    stream    tcp    nowait    fax    ${USRETC}/faxd.recv    faxd.recv

faxd.recv accepts requests for transmitting facsimile and creates the appropriate queue and document files in the FlexFAX spooling area. If a job is received properly, a request to process the job is then sent to a facsimile server by writing to a FIFO special file named FIFO in the spooling directory. faxd.recv then returns a message to the client indicating the identifier (an integer number) associated with the job. This job identifier can be used at a later time to remove the job from the queue and to query the job's status.  

DIAGNOSTICS

Diagnostics generated by faxd.recv are logged with the syslog(3) facility. Additionally, the user is informed of any problem that affects the status of the queued job. The following messages may be returned to a user (and printed on the standard output by sendfax(1)):

Can not create qfile "%s". A problem occured while trying to create the job description file in the sendq subdirectory.

Warning, no server appears to be running. This is an information message that indicates the job was queued for processing, but that no facsimile server(s) appear to be running.

Can not change to spooling directory. There was a problem doing a chdir(2) to the spooling directory.

Protocol botch. There was a protocol botch between the client and faxd.recv. This should never happen.

Problem setting up document files. A problem occured during the last step of the job submission process. In this step temporary copies of the documents that are to be sent are placed in the docq subdirectory with link(2) operations. This message indicates potential problems with the setup of the spooling area.

Protocol botch, no data byte count. There was a protocol botch while transferring a document file.

Could not create data temp file. There was a problem creating a temporary file in the temp subdirectory.

Protocol botch, not enough data received. faxd.recv did not receive as much data as the client specified would be sent. This should not happen.

Write error. faxd.recv encountered an I/O error while receiving a document to transmit.

Can not handle "%s"-type data. The client asked to send a document type that faxd.recv does not understand how to handle. The only valid document types are postscript (for PostScript language documents) and tiff (for TIFF Class F images).

Problem opening sequence number file. faxd.recv was unable to open the file sendq/seqf that holds the current sequence number used in setting up jobs for transmisssion.

Problem updating sequence number file. There was a problem updating the sequence number stored in the file sendq/seqf. This should not happen.

Protocol botch, unexpected EOF. The client closed the connection prematurely.

Protocol botch, malformed line "%s". The client sent a malformed protocol request.

Protocol botch, no requestor name. The client failed to send the name of the account that is submitting the job.

Problem accessing send directory. faxd.recv was unable to access the sendq subdirectory.

Problem accessing spool directory. faxd.recv was unable to access the spooling directory.

Can not get your network address. faxd.recv was unable to get the client's machine name in order to verify the client is allowed to submit a job.

The server does not have a permissions file. The facsimile server is missing the file etc/hosts. This file must be present and contain a list of the hosts that are allowed to submit jobs.

Your host does not have permission to use the fax server. The client's host is not permitted to submit jobs to this server. Only those hosts listed in the file etc/hosts are permitted to submit jobs.  

FILES

${SPOOL}                    spooling area
${SPOOL}/FIFO               for submitting the job
${SPOOL}/sendq              where job description is placed
${SPOOL}/sendq/seqf         for job identifier
${SPOOL}/temp               temporary location of job-related files
${SPOOL}/bin/submit2at      for jobs submitted to at
${SPOOL}/docq               where document files are placed
${SPOOL}/log                for server log files
${SPOOL}/status             for server status information
${SPOOL}/config.device      for returning server status
${SPOOL}/etc/hosts          host access control list
 

BUGS

The protocol is a abortive mismash of ad-hoc mechanisms.  

SEE ALSO

sendfax(1), intro(4F), faxalter(1), faxrm(1), faxstat(1), faxd(1M), hosts(4F), syslog(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
DIAGNOSTICS
FILES
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 10:15:15 GMT, January 04, 2023